用户发起提现申请时,你可以请求一个 withdrawal
对象,之后你可以对该笔提现进行审核,发起提现确认或提现取消。注:微信服务商模式商户暂不支持提现。
参数 | 描述 |
---|---|
id string | 提现对象 ID,由 Ping++ 生成。 |
object string | 值为 "withdrawal"。 |
app string | 对应 app 对象的 id ,查看 如何获取App ID。 |
amount int | 提现扣除的余额,单位为分。 |
asset_transaction string | 关联的 asset_transaction 对象的 id 。 |
balance_transaction string | 关联的 balance_transaction 对象的 id 。 |
channel string | 提现使用的付款渠道:wx (微信 App)、wx_pub (微信 JSAPI)、wx_lite (微信小程序)、alipay (支付宝)、 unionpay (银联)、allinpay (通联)、jdpay (京东)。此外,还支持使用自定义渠道 custom ,该渠道不需要真实付款,并在确认提现时同步返回成功结果。 |
created timestamp | 创建时间,用 Unix 时间戳表示。 |
description string | 附加说明,最多 60 个 Unicode 字符。 |
extra hash | 附加参数,提现付款的相关信息。 |
failure_msg string | 错误消息的描述。 |
fee int | 手续费,可能是渠道/银行收取。 |
livemode boolean | 是否处于 live 模式。 |
operation_url string | 支付宝批量付款 URL。 |
order_no string | 提现的商户订单号。 |
source string | 关联的 transfer 对象的 id 。 |
status string | 提现状态,已申请:created ,处理中:pending ,完成:succeeded ,失败:failed ,取消:canceled 。 |
time_canceled timestamp | 提现取消时间,用 Unix 时间戳表示。 |
time_succeeded timestamp | 提现成功时间,用 Unix 时间戳表示。 |
user string | 提现关联 user 对象的 id 。 |
user_fee int | 需要用户承担的手续费,单位为分。 |
settle_account string | 提现使用的 settle_account 对象的 id 。 |
metadata hash | 详见 元数据。 |
{
"id": "1701611150302360654",
"object": "withdrawal",
"app": "app_1Gqj58ynP0mHeX1q",
"amount": 20000,
"asset_transaction": "",
"balance_transaction": "",
"channel": "unionpay",
"created": 1472648887,
"description": "test232description",
"extra": {
"account": "6225210207073918",
"name": "姓名",
"open_bank_code": "0102",
"prov": "上海",
"city": "上海"
},
"fee": 200,
"livemode": true,
"metadata":{},
"order_no": "20160829133002",
"source": null,
"status": "created",
"time_canceled": null,
"time_succeeded": null,
"user": "user_001",
"user_fee": 50
}